Hot Spot Information Atom Structure
A hot spot information atom contains general information about a hot spot. The structure of a hot spot information atom is defined by the
VRHotSpotInfoAtom
data type:
typedef struct VRHotSpotInfoAtom {
UInt16 majorVersion;
UInt16 minorVersion;
OSType hotSpotType;
QTAtomID nameAtomID;
QTAtomID commentAtomID;
SInt32 cursorID[3];
Float32 bestPan;
Float32 bestTilt;
Float32 bestFOV;
FloatPoint bestViewCenter;
Rect hotSpotRect;
UInt32 flags;
UInt32 reserved1;
UInt32 reserved2;
} VRHotSpotInfoAtom, *VRHotSpotInfoAtomPtr;
-
majorVersion
-
The major version number of the file format.
-
minorVersion
-
The minor version number of the file format.
-
hotSpotType
-
The hot spot type. See
"Hot Spot Types"
for a description of the predefined hot spot types.
-
nameAtomID
-
The ID of the string atom that contains the name of the hot spot. This atom should be a sibling of the hot spot atom. The value of this field is 0 if no name atom exists.
-
commentAtomID
-
The ID of the string atom that contains a comment for the hot spot. This atom should be a sibling of the hot spot atom. The value of this field is 0 if no comment atom exists.
-
cursorID
-
An array of three IDs for custom hot spot cursors (that is, cursors that override the default hot spot cursors provided by QuickTime VR). The first ID (
cursorID[0]
) specifies the cursor that is displayed when it is in the hot spot. The second ID (
cursorID[1]
) specifies the cursor that is displayed when it is in the hot spot and the mouse button is down. The third ID (
cursorID[2]
) specifies the cursor that is displayed when it is in the hot spot and the mouse button is released. To retain the default cursor for any of these operations, set the corresponding cursor ID to 0.
-
bestPan
-
The best pan angle for viewing this hot spot.
-
bestTilt
-
The best tilt angle for viewing this hot spot.
-
bestFOV
-
The best field of view for viewing this hot spot.
-
bestViewCenter
-
The best view center for viewing this hot spot.
-
hotSpotRect
-
The bounding box for this hot spot, specified as the number of pixels in full panoramic space. This field is valid only for panoramic nodes.
-
flags
-
A set of hot spot flags. Currently, this field is unused.
-
reserved1
-
Reserved. This field must be 0.
-
reserved2
-
Reserved. This field must be 0.
© 1997 Apple Computer, Inc.Previous | Overview | Contents | Next
